home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 34.zip / BS1 part 34 / FredFish PD 305.adf / Mackie / README < prev    next >
Text File  |  1990-01-17  |  10KB  |  240 lines
  1. Mackie 1.4 release
  2.  
  3. - Never #n keyword added; says to `never' to front this CLI.  Useful if you want
  4.   a CLI open for logging all the time (like I do) but don't ever want to select
  5.   it (like I do.)
  6. - Select programs names from CLI command invocations *after* any colons or
  7.   slashes, so things work with latest WShell.
  8.  
  9. Mackie 1.3 release
  10.  
  11. - Automatic generation of different patterns
  12. - `patterns' keyword removed
  13. - Spline bug removed
  14.  
  15. Mackie 1.2 release
  16.  
  17. - Selection of five screen blanking modes
  18. - New `patterns' keyword to select blanking mode
  19. - Changes screen blanking patterns every five minutes
  20.  
  21. Mackie 1.13 release
  22.  
  23. - Faster, machine language splines
  24. - Changes from splines->boxes->lines
  25.  
  26. Mackie 1.12 release
  27.  
  28. - Adds splines (compile with -DSPLINES)
  29. - Time of `0' disables screen blanking
  30.  
  31. Mackie 1.11 release
  32.  
  33. This release fixes a few bugs in the 1.1 alpha release.
  34.  
  35. - Function keys work now.
  36. - Any spawned commands have a priority of 0, not 20.
  37. - The -f option works.
  38. - The .mackierc file is closed after it is read.
  39. - Some minor space improvements.
  40.  
  41. Mackie 1.1 (beta release for 1.2) is now available.  This revision has
  42. significantly greater functionality than the original Mackie, and I am
  43. releasing it in hopes of getting comments and improvements.
  44.  
  45. To get the program, anonymous ftp it from labrea.stanford.edu (in ~pub)
  46. or send me mail; I'll send it to you by Email or physical mail (at least
  47. to the first 20 people who ask).  You'll get both source and executable;
  48. comments on the source is greatly appreciated.
  49.  
  50. Those of you who have used Lisp machines or TI Explorers will recognize
  51. how this works.  I've added a `System' key to the Amiga, by taking over
  52. the help key.  If I want to edit a file, I simply hit `Help' then `E'.
  53. If an editor already has a window open, it will be popped to front;
  54. otherwise, an editor will be spawned.  Similarly, `Help' `V' will give
  55. me a VT100 window, whether one exists or not.  If I want a new editor,
  56. regardless of ones that current exist, `Help' CTRL-E will give me one.
  57.  
  58. Let's plunge right in, by examining my current startup file.
  59.  
  60. *
  61. *   Typical .mackierc file; set the default pop
  62. *   command:
  63. *
  64. command "newwsh con:10/10/640/200/MackieCLI"
  65. ;
  66. ;   and the timeout:
  67. ;
  68. timeout 200
  69. #
  70. #   Now define some system keys
  71. #
  72. space cli "" "newwsh"
  73. t cli "tex*" "newwsh con:20/20/640/100/texwsh cmd tex"
  74. p intuition "preview*" "preview"
  75. e intuition "mg*" "mg"
  76. v intuition "vt100*" "run vt100"
  77. d intuition "dfc*" "dfc"
  78.  
  79. w intuition ""
  80.  
  81. So, all the POPCLI stuff is still in there.  I'll address the system keys
  82. one by one.
  83.  
  84. The line that starts with `space' means that whenever `Help' `Space' is
  85. pressed, the next CLI window that matches the empty string is brought
  86. to the front.  The only CLI windows with a null command are the ones
  87. not executing a command, so this gives me a CLI ready for a command.
  88.  
  89. The line that starts with `t' means that `Help' `t' will look for a CLI
  90. executing a command starting with the three characters `tex', and pop it
  91. to front.  If one doesn't exist, one is started.  Note that all string
  92. comparisons here are case insensitive, and that `*' means match all the
  93. rest of the characters.
  94.  
  95. The syntax for the startup file is each line is an empty line, a comment,
  96. a parameter line, or a system key definition.  Comment lines start with
  97. semicolons, hashes, or splats.  Parameter lines start with `command',
  98. `timeout', `blank', or `lines'.  Timeout must be folled by a number,
  99. and command must be followed by a string.  Separators are tabs, spaces,
  100. equal signs, commas, or hyphens.
  101.  
  102. System key definitions start with the key being defined.  Allowable
  103. keys are A-Z or 0-9 (as themselves), F1 through F10 for the function
  104. keys, or Space for the space key.  The keyword `Shift' can precede the
  105. key.  After the key, an optional `CLI' or `Intuition' keyword can be
  106. placed.  These will be described later.
  107.  
  108. After the optional keyword, one or two strings should be found.  The
  109. first string is the command to match; the second string (if given) is
  110. the command to execute if no matches are found.  This command should
  111. return relatively quickly; if the program doesn't detach, then you want
  112. to precede the command with a `run' or `newcli' so it does.
  113.  
  114. Strings are bracketed by double quotes; a backslash-double quote means
  115. a literal double quote.
  116.  
  117. Any key that doesn't have a definition in the startup file gets a default
  118. definition; for the letter keys A-Z, the default definition is
  119.  
  120. X "X*"
  121.  
  122. for example, which means match any window starting with `X', be it a CLI
  123. or an Intuition window.  The number keys match only the CLI with that
  124. particular number.  The space key by default matches any window (so it just
  125. cycles all of the windows), and the function keys match nothing.
  126.  
  127. Windows are not matched by their title; the title is often blank or used
  128. for error messages and the like.  Instead, windows are matched by the
  129. name of the task associated with the window for Intuition windows, or the
  130. command being executed by the CLI in the case of CLI windows.  Thus, the
  131. program doesn't work very well with programs that use strange task names.
  132. For instance, Manx db uses the name `Aztec_db', so you'd have to match
  133. that, rather than the intuitive `db'.
  134.  
  135. There are three classes of programs.  There are those programs that run
  136. from the workbench or detach themselves from a CLI; these programs have
  137. only an Intuition window associated with them.  An example of this class
  138. is Manx `db'.  There are those programs that interact only through the CLI
  139. windows; an example of these is `tex'.  And finally, there are programs
  140. that run from a CLI but do their interaction through an Intuition window;
  141. an example of this is `vt100'.
  142.  
  143. Only the third class offers any ambiguity; the question is whether to
  144. active the CLI window or the Intuition window.  But the type of window is
  145. usually specified for the other kinds anyway, to help limit the search.
  146.  
  147. If you give a search string such as `!xyzzy!' that isn't likely to be
  148. matched, then the command string is always executed, so you can bind
  149. arbitrary commands to a system key.
  150.  
  151. Oh, yes; one important thing.  Hitting `help' twice passes a help key
  152. on through the input stream, so you haven't lost your help key.
  153.  
  154. The code will only compile with Manx.
  155.  
  156. Usage is simply:
  157.  
  158.    run mackie [-q] [-l] [-b] [-f filename] [command] [time]
  159.  
  160. Note that it doesn't automatically detach itself, so the `RUN' is
  161. necessary.  The first time you run it, it loads itself into RAM.
  162. Subsequent invocations need not be `run', as they notice the running
  163. portion of the program and simply send new parameters to it.
  164.  
  165. The options mean:
  166.  
  167.    -q             Quit.  Remove the resident portion from memory.
  168.    -l             Lines.  Draw lines instead of a blank screen.  (Default)
  169.    -b             Blank.  Draw a blank screen instead of fancy lines.
  170.    -f filename    Startup file (default is s:.mackierc).
  171.  
  172. A time is an argument that starts with a digit; this time is in seconds.
  173. After that much inactivity, the screen blanking starts.
  174.  
  175. A command is an argument that starts with neither digits nor a hyphen.
  176. This is the command executed whenever left-amiga ESC is pressed.
  177.  
  178. Thus, the command
  179.  
  180.    run mackie "newcli con:10/10/640/200/MackieCLI"
  181.  
  182. starts mackie up, and sets the command to be executed to a NewCLI with a
  183. specified size.  Later, if you want to see the screen blanking feature
  184. quickly, just type
  185.  
  186.    mackie 1
  187.  
  188. and in a second, the screen will go blank.  If the lines are driving you
  189. wild, you might type
  190.  
  191.    mackie -b
  192.  
  193. to turn them off.  Finally, you need every byte of memory, so you want to
  194. remove mackie.  Simply type
  195.  
  196.    mackie -q
  197.  
  198. That's all there is to it.
  199.  
  200. Enjoy this program!  Send bug reports to Tomas Rokicki, Box 2081,
  201. Stanford, CA  94309.
  202.  
  203. Based on:
  204.  
  205. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  206. /* |_o_o|\\ Copyright (c) 1986 The Software Distillery.  All Rights Reserved */
  207. /* |. o.| || This program may not be distributed without the permission of   */
  208. /* | .  | || the authors.                                                    */
  209. /* | o  | ||    Dave Baker     Ed Burnette  Jay Denebeim John Mainwaring     */
  210. /* |  . |//     Gordon Keener  Jack Rouse   John Toebes  Doug Walker         */
  211. /* ======                    BBS:(919)-471-6436                              */ 
  212. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  213.  
  214. POPCLI III by John Toebes © 1987 The Software Distillery.  All Rights Reserved
  215.  235 Trillingham Ln, Cary, NC 27511
  216.  
  217. Contributions to continue development of this and other fine products for the
  218. Amiga should be sent to the Software Distillery at the above address.
  219.  
  220. Other Products produced by the Software Distillery are:
  221.    BLINK    - the Turbo-charged Alink replacement
  222.    HACK     - The Amiga port of the famous UNIX game
  223.    LARN     - Another famous UNIX game
  224.    MEMWATCH - Protects your machine from random trashes
  225.    MAKE     - A software development tool one shouldn't be without
  226.    KERMIT   - The World renown file transfer protocol brought to the Amiga
  227.    ICONEXEC, SETALTERNATE, SETWINDOW - Icon manipulation tools
  228.    TSIZE    - A short utility for determining directory sizes.
  229. All of these are available on our BBS.
  230.  
  231. Permission is hereby granted to distribute this program provided both this
  232. documentation accompanies the executable and that no charge is made for its
  233. distribution.
  234.  
  235. POPCLI (pronounced POP-SEE-EL-EYE) is designed to solve two problems at once.
  236. First it provides a simple way of starting another CLI at any time without
  237. having to load workbench or exit whatever program you may be using.  Second
  238. it has a builtin screen saver mode that automatically turns off the Amiga
  239. display when there has been no input for a given period of time.
  240.